Java Native Screen Element Identification Details

You can select any Java Native screen element in the Screen Elements tree to display its identification details in the Identification tab.

Java Native General Screen Element Identification Details

The following identification details are available for JN Generic screen elements in the Identification tab. Because this type is the basic type from which all other Java Native screen element types inherit their identification details, these details are relevant for all other Java Native screen elements.

For more information on working with the options in this tab, see Using the Identification Tab.

Option

Description

Enable Recognition When this checkbox is selected, the screen element and all its children are recognized when the project loads and can be used in projects. By default, all screen elements are recognized and can be used. Clear the checkbox if you want to disable a screen element, so that the screen element and all its children are ignored and not recognized when the project loads.
Edit code

When this checkbox is selected, you can make changes to the identification code in the Code tab.

The Edit code option is designed for advanced users only.

Multi Instance Settings

If the screen element might have multiple instances, select the Has multi instances checkbox, and then specify which instance should be given precedence: Last Focused, First Recognized, or Last Recognized.

For more information, see Multiple Instances of the Same Application.

Advanced Settings

The Enable Continuous Mode checkbox is cleared and cannot be selected for Java Native screen elements.
Screen Element Type

The type of captured screen element. The Real-Time Designer automatically selects the type from the following options:

  • Process (only available when the process screen element is selected, as described in Java Native Process Screen Element Details.

  • Win32 Form (only available when the Win32 Form screen element, which is the parent to the rest of the screen elements, is selected, as described in Java Native Main Window Screen Element Identification Details.

  • JN Frame (only available when the top-level Java node is selected).

  • JN Internal Frame

  • JN Generic

  • JN Button

  • JN Context Menu

  • JN Check Box

  • JN Combo Box

  • JN Context Menu

  • JN Expand Bar

  • JN Label

  • JN Link

  • JN List Box

  • JN List View

  • JN Menu Item

  • JN Radio Button

  • JN Scroll Pane

  • JN Tab Bar

  • JN Table

  • JN Text Box

  • JN Toggle Button

  • JN Tree

Relations Area

The Main Relation Type drop-down list shows the available relation types for the screen element. The Real-Time Designer automatically selects the optimal relation type.

Self properties

All the properties that can be used to uniquely identify the screen element. The Real-Time Designer selects the optimal properties, indicated by the Used checkboxes.

For a full list of the available self-properties, see Java Native Screen Element Self-Properties.

Java Native Main Window Screen Element Identification Details

The following identification details are available for Win32 Form screen elements that represent the top-most Java window in the in the Identification tab. For more information on working with the options in this tab, see Using the Identification Tab.

Option

Description

Enable Recognition When this checkbox is selected, the screen element and all its children are recognized when the project loads and can be used in projects. By default, all screen elements are recognized and can be used. Clear the checkbox if you want to disable a screen element, so that the screen element and all its children are ignored and not recognized when the project loads.
Edit code

When this checkbox is selected, you can make changes to the identification code in the Code tab.

The Edit code option is designed for advanced users only.

Multi Instance Settings

If the screen element might have multiple instances, select the Has multi instances checkbox, and then specify which instance should be given precedence: Last Focused, First Recognized, or Last Recognized.

For more information, see Multiple Instances of the Same Application.

Screen Element Type

The type of captured screen element, in this case, Win32 Form.

Relations Area

The Main Relation Type drop-down list shows the available relation types for the screen element. The Real-Time Designer automatically selects the optimal relation type from the following options:

  • The Process I am a Top Window of: A parent Process level, under which the screen element was captured. This relation type is only applicable for defining a relation of a top window in the hierarchy.

  • The Process Top Window I am a Child of: A parent Process level.

  • The Process I am a Top Window Hosted of: A process where the top window is hosted.

  • My Parent Window is: The screen element’s parent object located one level above in the hierarchy.

  • The Window I am Descendant of: The screen element’s parent object located at any level above in the hierarchy.

  • My Process is: The process level, under which the screen element has been captured. This relation type is applicable for any object in the screen element’s hierarchy.

  • My Hosted Process is: The process, under which the screen element is hosted.

  • My Grand Parent Window is: The grand parent window.

  • My Child Window is: The screen element’s parent object located one level above in the hierarchy.

  • My Descendent Window is: The screen element’s descendent window.

  • My Hosting Parent Window is: The screen element’s parent window.

Self properties

All the properties that can be used to uniquely identify the screen element. The Real-Time Designer selects the optimal properties, indicated by the Used checkboxes.

  • My Window Class Name is: The name of the class to which the screen element belongs.

  • My Window Children Count is: The number of child objects.

  • My Window Visibility is: Identifies a window based on its visibility.

  • My Window Relative Location is: Identifies a window based on the location of its parent window.

  • My Window Width is: Window width in pixels.

  • My Window Height is: Window height in pixels.

  • My Window Child Id is: The window ID.

  • My Window Z Order is: The window position in a stack of overlapping windows.

  • My Window Class Z Order is: The class of the window’s position in a stack of overlapping windows.

  • My Window Name is: A window name where Win32 physical object is hosted.

  • My Window Accessible Name is: Provides accessibility support.

  • My Child Window Class Name is: Gets the name of the class, to which the child object belongs.

  • My Child Window Name is: Indicates having a child with specified name.

  • My Child Window Accessible Name is: Indicates having a child with specified accessible name.

  • My Child Window Child Id is: Indicates having a child with this ID.

  • My Child Window Children Count is: Indicates having a child with defined children count.

Java Native Process Screen Element Details

The following identification details are available for Java Native Process screen elements in the in the Identification tab. For more information on working with the options in this tab, see Using the Identification Tab.

From 7.8, if the value of process self property is changed, the system automatically refreshes to capture the hierarchy of the new process.

Option

Description

Enable Recognition of Children When this checkbox is selected, the process and all its children are recognized when the project loads and can be used in projects. By default, all screen elements are recognized and can be used. Clear the checkbox if you want to only recognize the process, without its children when the project loads.
Edit code

When this checkbox is selected, you can make changes to the identification code in the Code tab.

Multi Instance Settings

The Has multi instances checkbox is selected and cannot be cleared for Process screen elements.

For more information, see Multiple Instances of the Same Application.

Screen Element Type

The type of captured screen element, in this case Process.

Self properties

All the properties that can be used to uniquely identify the Process. The Real-Time Designer selects the optimal properties, indicated by the Used checkboxes.

The available self properties include:

  • My Process Name is: The name of the process, for example javaw.

  • My Process ID is: The ID issued by the operating system to uniquely identify an active process. For example, a text box control

  • My Parent Process Name is: The name of the parent process, if such a process exists.

  • My Parent Process Name is not: The name of the process, which can’t be a parent process.

  • My Process Level is: The process level in the process tree. This enables you to handle scenarios where applications have more than one process on different levels.

Java Native Screen Element Self-Properties

All Java Native screen elements use the following self-properties:

Property

Description

Index in Container The index number of the screen element in its container. When you are working with Oracle forms, the object hierarchy is dynamic, therefore the index number of an object in its container is not consistent. As a result, the Index in Container property cannot be used to accurately identify the frame. In this case, if this property is selected by default, deselect it, and used Visual Index property instead.
Java Class Name The Java name of the screen element's class.
Title The title of the screen element (only relevant for JN Internal Frame screen elements). The value of this property should be the display name of the internal frame.
Path The path to the screen element.
Visual Index The visual index (topology) of the screen element.
Text The text value of the screen element, if applicable.
Width The width of the screen element.
Height The height of the screen element.
Top Offset in Window The top offset of the screen element in the main Java window.
Left Offset in Window The left offset of the screen element in the main Java window.
Top Offset in Container The top offset of the screen element in its container.
Left Offset in Container The left offset of the screen element in its container.